GEMDOS Technical 
Specifications Version & 


GEMDOS Spec Version 8 


Revision History 


Version 6 contains the complete object module format material, the hardware 


requirements, and the development environment. 
-Version 7 contains corrections from the 2-20 meeting. 


Version 8 (this one) contains corrections from the 2-28 meeting, plus some new BIOS 


notes, and material explaining the error reporting, base page format, and user interface. 


Sections needing information or completion. 


dis section (to come) 
VCE note 


4.0 Memory Models 
5.0 Base Page Format 
6.0 System Status Codes 


7.6 AUX_IN C binding 

7.7, AUX_OUT C binding 

7.8 PRINT-OUT C binding 

7.10 DIRECT CON_IN C binding 

7.11 CON_IN (No echo) C binding 

7.15 AUXIN_STAT function number 

7.16 AUXOUT_STAT function number 
CONOUT STAT function number 
PRTOUT_STAT function number 

7.19 Reset Disk C binding 

7.21 Current Disk C binding 

7.22 Set Disk Transfer Address C binding 

7.23 Get Date C binding 

7.24 Set Date C binding 

7.25 Get Time C binding 

7.26 Set Time C binding 

7.28 Get Version Number C binding 

7.29 Keep Process C binding 

7.30 Get Disk Free Space C. binding 

7.45 SETBLOCK C binding 


8.8 Unresolved comment about parameters 
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1. Hardware Requirements (Minimum and Optimum) 

The GEMDOS operating system requires a minimum system configuration that suppons 
its capabilities. in particular, this includes both RAM and ROM storage, a bit-mapped 
video controller and display, and a mouse or other pointing device. 

- 68000 microprocessor 


Bit mapped video controller card and a display with 
320 by 200 resolution 


128 Kbytes RAM 


160 Kbytes ROM 


An optical or track mouse, or other pointing device 


While GEMDOS runs and “exercises” its features with the system configuration above, 
the expanded high-performance system described below. uses the full capabilities of 
GEMDOS. 


68010, 68020, or 68070 advanced microprocessor 


High resolution, color bit-map display and controller 
(640 by 400 pixel resolution, barrel shifter hardware 
for very high speed screen refresh) 


- 256 Kbytes of RAM to support sophisticated applications 
and multitasking 


- 192 Kbytes of ROM, including additional desk accessories 
- Mouse 
- Disk drives and controllers 


- Optical drives and controllers 


- Printer and communication ports 


Develooment Environment 
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2. Development Environment 
The OEM hardware-specific code development is supported on a Motorola VME-16 
system with a graphics display monitor, 256 Kbytes of additional RAM, a terminal, a 


VME-400 dual serial port, and a Mouse Systems serial mouse. 


You have the option of coding in a cross-development environment, under CP-M68K, or 
coding in GemDos 1.0 native mode. In native mode, you can use prototypes of new 


hardware added to the VME-10 as expansion boards. 
The. Apple Lisa will support an alternative native mode development environment. 


You can transport GemDos to the target system with the “Kermit” communications 


program. 
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3. Object File Format 


3.1. Advantages of the GEMDOS Object File Format 

Presently, in the CP-M68K environment, the relocation information takes up the same 
amount of space in the object file as the text and data. That is, there is one word of 
relocation information for each word of text and data. The new format should reduce the 


relocation information to about 1-20th the size of the text and data, on the average. 
The new format can be used for linked programs, and it allows symbol table references. 


The format is easy for loaders to read, as all relocation entries occupy integral numbers 


of bytes. 


The format can be used in systems where text, data, and bss sections are allocated 


separately at load time. 


The format supports future processors, such as the 68020, which allow addresses to fall 


on odd boundaries. 


3.2. Changes to the File Header 


The file header number is 601C rather than 601A. In all other respects, it is identical to 


the old file header. 


3.3. Reiocation Information 
The new format is a subset of the old format, with a few features deleted due to lack of 


use. Specifically, the deleted features are: 


va 


1) 16-bit relocatable addresses 


2) Relocation types that required no action: absolute, 
PC-relative, first word of instruction. 


There is one relocation entry for each relocatable address in the text and data sections 
that needs a fixup. Each entry needs from one (most commonly) to seven bytes. The 
relocation entry contains: 


1) A type-displacement byte (always present) 
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2) An optional displacement extension, consisting of 
1.2, or 4 bytes. 


3) An optional symbol table index (2 bytes). 


Type-Displacement Byte 


he displacement fieid is the offset added to the previous relocatable address to obtain 
the current, desired address. If this is the first such relocation entry in the file, adding 
the displacement value to the starting address of the file yieids the address of the first 


relocatable address. 


Because the contents of the displacement offset is limited to seven bits, some other 
scheme must be used to support displacements greater than 127 bytes. Accordingly, the 


displacement fieid has the following meaning: 


0 : End of relocation information: the relocation record is a dummy and 
does not perform a fixup. 


1 The actual displacement is contained in an unsigned byte immediately 
following the type-dispiacement byte. 


<« The actual displacement is contained in an unsigned word immediately — 


following the type-displacement byte. 


3 The actual displacement is contained in an unsigned 32-bit long word 
immediately following the type-displacement byte. 


4 through 127 The displacement is contained in the type-displacement byte itself. 
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The extra bytes following the type-displacement byte when the displacement vaiue is 


1,2, or 3 are called the displacement extension bytes. 


The type field has the following meaning: 
0 Normal load-time relocation record. 


1 Symbol reference. In this case, the relocatable address is an offset 

relative to a symbol in the object modules’s symbol tabdie. The index 
into the symbol table is a 16-bit word that follows the displacement 
extension bytes. , 


-A symbol reference wil! never appear in a loadabie, fully-linked 
program. 


3.4. Notes For Writing Loaders 
The object module itself contains the text and data sections in a contiguous block: ail 
addresses in the program are virtual addresses pointing into a program image whose 


base address is the text starting address given in the header. 


For example, if the starting virtual address of the text section is 0x400, and the length of 
the text section is 0x800, then the cata séction starts at virtual address OxCO0. if the 
address 0xD00 subsequently appears in the program, the address refers to a location 


otfset 0x100 from the start of the data section. 


If the text, data, and BSS are loaded in non-contiguous biocks, extra care must be taken 


when the relocation information crosses the boundary between the text and data sections. 


There is no explicit information in the relocation information that indicates when a 
boundary is crossed. The loader must check its pointer to the text and data sections 
during relocation each time it adds the displacement field, and it must adjust the pointer 


if it has crossed over from text to data. 


OR 
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4. CCP Commands 


Built-in Commands 


LS 

DIR 

CAT 

cD 

MD 

RD 

RM 

DEL 

REN 

SHOW 

INIT 

COPY 

GET TEMPORARY 

PUT TEMPORARY 

BREAK TEMPORARY: For debugging 
EXIT Terminate CLI and return to parent process 
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6. Base Page Format 


15 Base Pase Format 


PD /* BASEPAGE FORMAT */ 

{ 

/* 0x00 */ 

long p_lowtpa; /* beginning of TPA */ 

Tong p_hitpa; /* end of TPA + 1 */ 

‘long p_tbase; /* text (code) base */ 

long p_tlen; /* text (code) length */ 

FOX. *7 

long p_dbase; /* data base */ 

long p_dlen; /* data length */ 

long p_bbase; /* pss base */ 

long p_blen; /* bss length */ 

/* 0x20 */ 

char *p_ xdta? /* disk transfer address */ 

PD *p_ parent; /* parent PD */ 

char piddrv; ; 

char p_curdrv; -/* current drive */ . 
char p_uft(NUMSTD];/* index into sys file table for std files 
/* 0x30 */7 

char p_curdir{16]; /* index into sys dir table" 
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7. System Status Codes 
GEMDOS uses: a simpie convention to return system Status and error codes. Both types 


of codes are returned in register DO.L 


if the upper word in DO.L is FFFF, the content of the lower word is the returned code, 


7 ' put this code must be NEGATED to obtain the correct error code. 


~When DO0.L holds a word or byte value returned as a status code, the upper word is set 


to 0000 and the lower word contains the returned information. 


7.0.1. Error Codes 


OK 0 

Error ~1 

Drive not ready -2 
Unknown command -3 


CRC error 4 
Bad request 5 

| Seek error -6 

| Unknown media -7 
Sector not found -8 

| No paper -9 

| Write fault ~10 

! Read fault -11 

| Generai mishap -12 

| Write protect “13 

| Media change -14 


| Unknown device -15 


ale: Se Sata a MARE aa a aaa as BR 
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8. System Function Calls 


8.1. GEMDOS Parameter Passing Conventions 
The GEMDOS system function calis use a common parameter passing convention. This 


convention supports use of system function calls by C and other high level languages. 


Each system function call reference from a high level language fills a parameter block 
with the number of the function call, necessary parameters, and other data relevant to 


that function (such as drive number, time-of-day code, etc.) 


Once the parameter biock is built, simply perform a TRAP number}, and the operating 


system interprets the call and carries out the action. 


The GEMDOS parameter blocks have the following form: 


Pema es ratte t arene ewe sseensesoas= + Low memory (Parameter 
| Function Number | ' block addr) 


oe www ew we wm ow we eee we www wwe ew we we ~+ 
| | lst Parameter 
| | 2nd Parameter 


| | 3rd Parameter 


| | 4th Parameter 


tenn----------- wwe nee eH ee ee + High memory 
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in this diagram, the position of the parameters and the function number correspond to 


the way C places them on the stack Specifically, the C code: 
CALL (functionnumber, P1, P2, P3, ... Pn) 


loads the Nth parameter into the parameter block first, followed by the N-ith, and 


continues in this manner until the function number is entered last in the parameter block. 


8.2, Returned Data 

The default convention returns all byte, word, and long data in DO. In individual cases 
where more information is returned, DO contains the address of an Information Return 
Block, which receives the data. The descriptions of individual function calls ‘explain how 


ta returns to the application. 


FE A aT OTE eT CN Le Oe ee ge Coe ge eC Ee seas ee 


TERM 


teen nner en nnn een r ene woc-------+ Low memory (Parameter 
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8.3. 00: TERM 
VOID 
xterm({) 
{ 
Parameter Block 

| Function Code 00H 

ewe eww ww ecewae ween wen wre w eee ewe wee 
Function: 


| block addr) 


Terminate this process, return to parent process with return code 


set to 0. 
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8.4. 01: CONIN 


‘LONG 
coning) 
{ 
} 


Parameter Block 


| Function Code 01H 


Return Parameters: 


Register D00.L : Character read 


Function: 


CONIN 


+ Low memory (Parameter 
| block 
+ High memory address) 


Reads character from standard input and echoes it to the standard 


tput device. 


If the console is the standard input device, and if the console 
emulates GSX 2.0. the console scan code is found in the low byte 
of the high word. as shown below. This byte is set to 00 


otherwise. 


DO Contents 


Hb Hw Lb Hw Hb Lw Lb Lw 
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8.5. 02: CONOUT 


void 

conout(ch) 

_ WORD ~ ch: 

{ 

} 

Parameter Block 

tee Soca ee seer seca se eae sae e ~----+ Low memory (Parameter 
| Function Code 02H { block 
saat aan aha SSS Se + address) 
| Character | lst Parameter 
ial ach a ac + High memory 

Function: 


The first (and only) parameter is a word: lower 8 bits contain a 
character to be printed. The upper 8 bits shouid be zero to 
ure compatibility with future extensions to the 16-bit 
vacter. set. 


The function displays this character on the standard output 
device. 
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8.6. 03: Auxiliary Input 


Parameter Block 


$en------------------------------ + Low memory (Parameter 
| Function Code 03H | block addr) 
teres Aes eee SSS SSeS + High memory 


Return Parameters: 


Register D0.L : Character read from auxiliary port. 


Function: 


Receives character from auxiliary port and returns it in 00.L 
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8.7. 04: Auxiliary Output 


Parameter Block 


+ Low memory (Parameter 
Function Code 04H | block addr) 


| Parameter 
+ High memory 


Function: 


The character in the parameter block is sent to the auxiliary 
port. The upper 8 bits should be zero to ensure compatibility 
with future extensions to the 16-bit character set. 
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8.8. 05: Printer Output 


-Parameter Block 


Printer Outrut 


Psa Ser Seee ees tes Sse ses sees -+ Low memory (Parameter 

| Function Code 05H | block addr) 
$e ewe ne ee we ee we we et www ew ene eee + 

| Character to send | Parameter 

tos SaaS Sees wo anon ------------ + High memory 


Register DO.W : Character to send to printer. 


Function: 


Send the specified character to the printer device. The upper 8 
bits should be zero to ensure compatibility with future 
extensions to the 16-bit character set. 
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8.9. 06: RAWCONIO 


LONG 
rawconio(parm) 
WORD parm: 
{ 
} 
Parameter Block. 
Pests sesee sees eSeeeeseSesene=-s= + Low memory (Parameter 
| Function Code 06H | block addr) 
a a ee eee + 
| Word | Parameter 
Rese Ss ee SSeS eye ae are eae a + High memory 
Function: 


lf word = FF, read character from standard input device and 
return in 00.L 


word does not equal FF, it is assumed to be a character and is 
sent to the standard output device. 


lf no character is availabie, return DO.L equals OL 
Return Parameters: 


Register DO.W : If word = FF, DO.W contains character read 
from standard input device. 
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8.10. 07: Direct Con In Without Echo 


Parameter Block 


$e nnn ee + == + Low memory (Parameter 


| Function Code 07H | block addr) 
Pe eSeS Se SSCS See SeSe= sss Sesser = + High memory 


Return Parameters: 


Register DO.L : Character read from standard input device. 


Function: 


Read character from standard input device without echoing it to 
standard output device. Control characters pass through without 
trapping by the console routine. 


aetna eae te 
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8.11. 08: Con In Without Echo 


Parameter Block . 


toon n+ ----------------------- ---+ Low memory (Parameter 
| Function Code 08H { block addr) 
¥eseee= Seer serene ecenne “-------+ High memory 


neturn Parameters: 


Register DO.L : Character read from Standard input device. 


Function: 


Read character from standard input device without echoing it to 
standard output device. Control characters are interprated and 
have their proper effect. 
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872. 09: PRT_LINE 


voiID 
prt_line(p) 
BYTE . *p; 
{ : 
} 
Parameter Block 
Hr mr ret rer nnn tn nnn nnn nn ene + Low memory (Parameter 
Function Code 0SH | block addr) 
pr rr ewe ree wee wer ee ee wee -—+ 
| Address of string | Parameter 
+ oe + 
| to print (long) | 
sana areetate areata! + High memory 
Function: 


The target string is transmitted to the standard output device, 
character by character. A null character terminates the string. 
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8.13. OA: READLINE 


VOID 
readline(p) 

BYTE "p; 
{ 
} 


Parameter Block 


+ Low memory (Parameter 
block addr) 


Address of 


Input Buffer (long) 
+ High memory 


Function: 
Sets address of keyboard input buffer and reads a line from the keyboard. 


The first byte of the buffer contains the buffer size n, in bytes, and the second byte is 
: by GEMDOS, upon return, to the number of characters actually read. Character are 
read and stored from the third to n-1 bytes or until ENTER is read. If the bufter fills up 


to n-1, any character read but Enter causes the console bell to ring. The last character in 


the buffer is the carriage return (OOH) generated by ENTER. 
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8.14. 08: CONSTAT 


LONG 
. constat() 
{ 
} : 
Parameter Block 

Tess S =e ester ere SS Sees + Low memory (Parameter 

} Function Code OBH | block addr) 

aa aa a a al aa + High memory 


Return Parameters: 

Register DO.W : Contains FFFF if a character is available; 
0000 if no character available. 

Function: 


Returns the status of the keyboard, checking for characters to 
receive from it. : 


Sd es ak Ea ae laa le gd Beat a aia ead Sk i a I ee ie a Ba 
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8.15. XX: AUXIN_STAT 


LONG 
constat() 
{ 
} 
Parameter Block 

pa en a eo ee eee > + Low memory (Parameter 

| Function Code XXH e. block addr) 

$e menmn nen nnn nen rere cern r eer + High memory 


Return Parameters: 

Register DO.W : Contains FFFF if a character is available: 
0000 if no character availabie. 

Function: 


Returns the status of the auxiliary input device, checking for 
Characters to receive from it. 


BE ee 
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8.16. XX: AUXOUT_STAT 


LONG 
AUXSTAT() 
{ 
} 
Parameter Block 

teeccnnnno- (eee ee tn ene nnn enn nnn an- + Low memory (Parameter 

| Function Code XXH | block addr) 

a a a aa + High memory 


Return Parameters: 
| Register DO.W : Contains FFFF if the device is ready to receive a Character; 
0000 if it is unavailable. 

Function: 


Returns the status of the auxiliary device, cnecking to see if it 
ready to receive characters. 
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8.17. XX: CONOUT_STAT 


LONG 


a 


conout_ stat() 
{ m 
Parameter Block 
Pewee wee we we mee eee wwe wee we we we wee 
| Function Code XXH 
eee ete ae i rw ee ee ewe me ore re oe ae ee oe ee ne ee ee ee 


Return Parameters: 


36 


CONOUT STAT 


+ Low memory (Parameter 
| block addr) 
+ High memory 


Register DO.W : Contains FFFF if the console is ready to receive a character; 


0000 if it is unavailable. 


Fe in: 


Returns the status of the console device, checking to see if it 


ready to receive characters. 


1 
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8.18. XX: PRTOUT STAT 


LONG 
prtout_stat() - 
{ 
) 
Parameter Block 

ten en nnn - = +--+ +--+ == + + Low memory (Parameter 

| Function Code XXH | block addr) 

Hemmer rn nn ene n nn nnn nn nnn n = + High memory 


Return Parameters: 


Register DO.W : Contains FFFF if the printer is ready to receive a character: 
0000 if it is unavailable. 


Function: 


Returns the status of the printer device, checking to see if it 
ready to receive characters. 
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8.19. 00: Reset Disk 


Parameter Block 


+ Low memory (Parameter 
Function Code ODH | ~~ block addr) 


+ High memory 


Function: 


Disk reset. All file buffers are flushed, files are closad, and 
the directory is updated. When this drive is next accessed, the 
disk is logged in again. 
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8.20. OE: SETDRV 

LONG 
getdrv(newdrv) 

WORD newdrv: 
{ 
} 

Parameter Block 
ree er ao ee + Low memory. (Parameter 


| Function Code O0EH | 


Drive Number: 


O = Drive A, 1 = Drive B .... 15 = Drive P 


Return Parameters: 


Register DO.L : Number of drives in system. 


Function: 


Makes a specified drive in the range A-P the current drive and 
returns the tota! number of drives in the system. 


block addr) 
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8.21. 19: Current Disk 


Parameter Block 


pee nme n nna meen nen ne nnn nnn en enn + Low memory (Parameter 
| Function Code 19H | block addr) 


LeSa tenn Sete SaesS Sens eess se SaaS = + High memory 


“;ter DO.W : Contains code of the current drive number 
0 =A, 128, up to 15 = P. 
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8.22. 1A: Set Disk Transfer Address 


Register D1.L : Pointer to a long with with address of disk 
transter address. 


Parameter Block 


Poe mw emer en neem enw eee nasa eesneen + Low memory (Parameter 

| Function Code 1AH | block addr) 
thw we a a ee ee ee ee ee + 

| Disk Transfer ~ | 

+ + 

Address (long) | 

sa a a aa + High memory 


a a Fa at a al ii a a take eh a le ah 


ore: 
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8.23. 2A: Get Date 


t 


Parameter Block 


Low memory (Parameter - 
block addr) 
+ High memory 


Pa Evi 2 


te: Meee 
Pyteg op yey 


he 
Tr 


Re ‘’arameters: 


' il ryt 


$y 


Pah 


Register D0O.W : Contains date in the format: 


6s ail ee 
: 


tS ¥teitist 4 


Bits 0 through 4 indicate the date in the range 1 - 31 
Bits 5 through 8 indicate the month in the range 1 - 12 
Bits 9 through 15 indicate the year (since 1980) in the range 0-119 
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8.24. 2B: Set Date 


Parameter Block 


ha rn nn nen eee + Low memory (Parameter 

| Function Code 2BH | word block addr) 
hw we a wn we wr we ew ee eee eee wee + 

| Date “word | word 

Peseta eas sess SSeS lesa eee sess Se + High memory 


Date Word contains the new date in the format: 


Bits 0 through 4 indicate the date in the range 1 - 31 
Bits 5 through 8 indicate the month in the range 1 - 12 
Bits 9 through 15 indicate the year (since 1980) in the range 0-119 


WERpatred.r +. -eeecenmmanbansmnabalbibctenayicineenant 
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8.25. 2C: Get Time 


Parameter Block 


a a aa a a + Low memory (Parameter 
| Function Code 2CH | block addr) 


a a a aa a + High memory 


urn Parameters: 
Register D0.W contains the time-of-day in the format: 
Bits 0 through 4 indicate the binary number of two-second increments 


Bits 5 through 10 indicate the binary number of minutes 
Bits 11 through 15 indicate the binary number of hours 
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8.26. 20: Set Time 


Parameter Block 


ete SS Se ee wen ee + Low memory (Parameter 

| Function Code 2DH | word block addr) 
(ranean cacuwe Oe ww ww mw wee we wwe + - 
| Time Word | word 

¢ nm eee ewan enn nes eee rere eerecccc= + High memory 


Time Word contains the new time in the format: 


| Bits 0 through 4 indicate the binary number of two-second increments 
Bits 5 through 10 indicate the binary number of minutes 
Bits 11 through 15 indicate the binary number of hours 


RE EY Oe LEU Ee eae ee NY ne aT 
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8.27. 2F: GETDTA 


LONG 
getdta() 
{ 
} 
Parameter Block 
Hern enn nnn wn en ne + Low memory (Parameter 
| Function Code 2FH | block addr) 
t<<==5= nasa S68 SSS ase esse s=ese= + High memory 


Return Parameters: 


Register D0.L : Contains the current Disk Transfer Address. 


yee 
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8.28. 30: Get Version Number 


Parameter Block 


tenon no ------ +--+ === o-c--- + Low memory (Parameter 
Function Code 30H | , block addr) 
sania aes saa encod cdma Ca a aaa + High memory 


Return Parameters: 

Register D0.W : Contains version number. For first release, this 
number will 0100H. 

| Function: 


Lower byte contains minor version number; upper byte contains 
major version number. 0100 = version 1.00. 
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8.29. 31: Keep Process (Terminate and Stay Resident) 


Parameter Block 


+ Low memory (Parameter 


Function Code 31H | block addr) 


long 


word 
+ High memory 


Long: Contains number of bytes to keep 
Word: Contains exit code: 


0 = success 


1 * failure 


Note: Use of this function may make an application difficult to 
port to a future operating systems. 


ran gist owt 
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8.30. 36: Get Disk Free Space 


Parameter Block 


tonne e+ e+ +--+ + Low memory (Parameter 

| Function Code 36H | block addr) 
$e we ee ee ee we ee + 

| Address of | 

+ + long 

Information Return Buffer | 

+oe-e- owe me wee ee ee mene on + 

| Drive Code | word 

team ene nnn nee --- + ween eer nnn- + High memory 


Drive Code: 0 = the default drive, 1 = A, 2 = 8, etc. 


The information Return Buffer holds the data retrived by this 
function call. The format of the IRB is: 


Information Return Block 


$e ew ee wm wm we em ne ew ew ee we ew we ewww + 
| Long ) | 
Fe we a a en ow ee ee ee + 
| Long 1 | 
$e we ae wr wn we ww we www aw ee + s 
| Long 2 | 
$e en wn ew ew ee ee ween eee we -—+ 
| Long 3 | 


The Information Return Block contains 4 longs: 


Long 0: Number of free allocation units on the 
specified drive. 


Long 1: Total number of allocation units on the 
specified drive. 
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Long 2: Number of bytes per physica! sector. 


Long 3: Number of physical sectors per drive 
allocation unit. 
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8.31. 39: MKDIR 


LONG 
mkdir(path), 
BYTE “path: 
{ 
} 
Parameter Block 
pe ew ew ww ee mew wee eee eon 
| Function Code 398 
pew ewe ee mee wwe Cee www ew mmm ewe www owe 
| Address of String 
Ce 
Containing Pathname 
$e wee wos we em mmm oman waamewawaae 


The pathname for the new subdirectory is contained 


MKOIRS 


+ Low memory (Parameter 

| block addr) 
+ 

| 

+ long 

| 

+ High memory 


in 3 


null-terminated string. The parameter block contains the address 


of this string. 


} 


Return Parameters: 


Register DO.L : Contains 0 if operation succeeds, 
non-zero if error occurs. 


jek eke ZEEE Te at 


ai 
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8.32. 3A: RMOIR 


LONG 
rmdir{(path) 

BYTE ‘path; 
{ 
} 


Parameter Block 


+ Low memory (Parameter 
| block addr) 


Address of String | 

: + long 

Containing Pathname I 
+ High memory 


The pathname for the subdirectory to remove is contained in a 
terminated string. The parameter block contains the address 
is string. 


Return Parameters: 


Register DO.L : Contains 0 if operation succeeds. 
non-zero if error occurs. 


Function: 


Removes a subdirectory. If the subdirectory is not empty, an 
®rror code is returned in register D0.L 
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8.33. 3B: CHDIR 


LONG 
ehdir(pdrvpath) 
BYTE *pdrvpath; 
{ 
} 
Parameter Block 
tesreerS ssa SH SSS Seer Ssess Stes Ses + Low memory (Parameter 
l Function Code 3BH | block addr) 
$e een on wm ww oe we ee nn + 
| Address of String | 
+ + long. 
| Containing Pathname | 
te fa= Sere ee Sse Se eee eS ae + High memory 


The pathname for the new current directory is contained in a 
null-terminated string. The parameter biock contains the address 
of this string. 


Return Parameters: 


Register DO.L : Contains 0 if operation succeeds, 
non-zero if error occurs. 


eet ea ee wet ae ae aniey vo ner are Oe tee ee 
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8.34. 3C: CREATE 


LONG 
creat(name,attr) 
BYTE *name; 
WORD attr; 
{ ° . 
} 
Parameter Block 
towmenn ewer snes en enn--- wren ern n-- + Low memory (Parameter 
| Function Code 3CH { block addr) 
pe me en a we ee nn ee eee + 
| Address of String | 
+ + long 
| Containing Pathname of New Filel 
wwe www ee eee wn ow ow ee ew ee ee ee wee + 
| Attribute Word | 
fae SSR ee SES Se Saree pee ache + High memory 


The parameter block contains a long and word. 


Long is a pointer to a null-terminated string specifying the 
complete pathname of the new file. 


Word indicates file attributes, depending on these values: 
O1H File set to read-only 
02H File hidden from directory search 
04H File sat to system, hidden from directory search 
08H File contains volume label in first 11 bytes 


Return Parameters: 


Recister DO.L : Contains file handle if the file was cr2ated successfully, 


DOS Spec Version § 


negative if an error occurred. 


ant 
ut 
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8.35. 3D: OPEN 


LONG 
opentpname,mode) 
BYTE ‘*pname: 


WORD mode; . 
{ 
} 
Parameter Block 
tom n rrr errr nnn wenn eceenen= + Low memory (Parameter 
| Function Code 3DH | | block addr) 
$eeen— ie we ee a nn ee + 
| Pointer to string 
+ + Long 
| containing pathname i S 
pt oe ee ee ee wm ee we ee ee ee ee ew ene + 
| Mode Word | Word 
{Lesa eS Sae SSeS S Steer ee eet + High memory 
li } @ pointer to a null-terminated string containing the 
p. me of the file to open. 


Word contains a code indicating the file read-write mode: 
0 = file open for reading only. 


1 = file open for writing only 
2 = file open for reading or writing 


Return Parameters: 


Register D0.L : Contains fila handle if the file was opened successfully, 
negative if an error occurred. 
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8.36. 3E: CLOSE 
LONG 
Gose(handle) 
WORD handle; 
{ 
} 
Parameter Block 
prem ee ween nme nnn nnn eee n ne eenen= + Low memory (Parameter 
| Function Code 3EH | block addr) 
pm ww a ww wo rw en ww we ee ee ee + 
| File Handle | 
sala a lt la aa a + High memory 


Return Parameters: 


Register DO.L : Contains 0 if the file was closed successfully, 
non-zero if an error occurred. 


| 


be ee meee es: 


498 3 


OR EI SEE Te I eee Cae Te ge re 
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937. 3F: READ 
LONG 
read(handie,cnt.pbuffer) 
WORD handle; 
LONG cnt: 
BYTE - *pbuffer: 
{ 
} 
Parameter Block 
a ia a haa nl + Low memory (Parameter 
| Function Code 3FH © i. block addr) 
poem ewe wn we ee ee ee + 
I. File Handle | 
teen oe ++ rs 
| 
+ Number of bytes to read + Long 
| | 
ee ae ee a a ee ee ne ee ee + 
| 
Address of storage buffer + Long 
| | 
aaa aaa a a a + High memory 
ntains the file handle. 


Nord co 


Ong 1 contains the number of bytes to read 


ONg 2 contains the buffer location to store the read bytes. 


“8turn P 


] 


m egister 


arameters: 


DO0.L : Contains number of bytes read if read operation 
comcietad successfully, or an error code if an 
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error occurred. On an error condition, the high 
word of DO.L is set to FFFF. 


PO ee ae ee PR eR ee eat SEE Eye ee 


Ate eke ee 


ee ee ee 


reettoener? 
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38. 40: WRITE 


LONG 
rite(handle,cnt,pbuffer) 

WORD handle; - 

LONG cnt: 


BYTE *pbuffer: 


Parameter Block 


porn rn enn nn ne eee + Low memory (Parameter 

| Function Code 40H | block addr) 

Pl a ea Sl oS es es ae ara aw es eas So + = 

| File Handle | 

eae ee a we ae ie we a ee ee + 

| | 

+ Number of bytes to write + Long 

| | : 
pa ee ee ee eee a ew ee ee +> 


Address of storage buffer + Long , 
| | . 
a a al a + High memory 
Prd contains the file handle. 


Ng 1 contains the number of bytes to write 


Ng 2 contains the buffer location containing the bytes to write. 


Pee ee ee aS ES ee ee 


ea 
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Return Parameters: 


Register DO.L : Contains number of bytes written if write operation 
completed successfully, or an error code if an 
error occurred. On an error condition, the nie 
word of DO.L is set to FFFF. 


Ts Dae ee ee a ee a re 


WRITE 


Reco Gainey Cay) 
Uae in ate Ae 1 


£ 
$ 
. 
¢ 
{ 
{ 
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39. 41: UNLINK 


LONG 
snlink(name) 
BYTE *name; 


{ 
} 


JNU” “eletes files. 


Parameter Block 


$a nnn nn -- +--+ - == - --- = ----- === + Low memory (Parameter 
| Function Code 41H | block addr) 
$m ee a we ee ee ee ween + 
| Pointer to string - | 
+ + Long 
| containing pathname | 
teh Se SSNS en Sa SSeS eS + High memory 
Lon itainins the address of a nuil-terminated string 
Spe g the directory entry. 


Return Parameters: 


Register DO.L : Contains 0 if the file was removed, non-zero if 
an error occurred. 


eR, Cee ee ee SRE ed ee Pe eae ae ee aar Fe eee Lang ATR 8 TTA Se Fe EE Tt ee agora ee be ees 
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8.40. 42: LSEEK 


LONG 
lseek(softs, handie, smode) 
LONG softs; 


WORD handle; 
WORD smode; 


SY em 


| Parameter Block 


: a a aac SHSSreeSeaS + Low memory (Parameter 
| | Function Code 42H block addr) 
| hewn a we en wn eo ee ew + 
| + number of bytes + Long 
| | | | 
| pe a ew we a wr ee ee ee + 
| File Handle | Word 1 7 
: eR eee SS SS SSS SSS Ss 4 Fe eee See Ssee ; 
| ie File Pointer Mode Word | Word 2 
+----- Peer nnn ern + High memory 


Long contains N, the number-of-bytes argument. 
Word 1 is the file handle. 
Word 2 is the method used to move the file pointer: 


0 = move pointer to N bytes from beginning 
of file 


| 1 = move pointer N bytes from current 
location 


2 = move pointer to N bytes from end of file 


2 OS one eae ae ere rae eee aes Wie See See Ba Pl 
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sturn. Parameters: 


gister DO.L : Contains absolute file pointer location. as the 
number of bytes from the beginning of the file. 


Be PS, RTT Ree See ie ee ye cae ae ey 


| fm 
sobs 
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8.41. 43: CHMOD 


LONG 
chmod(p,wrt.mod) 
BYTE “p; 
WORD wrt,mod; 
C 
} 


Parameter Block 


a al a a a a a + Low memory (Parameter 

| Function Code 43H | block addr) 

pew nn nn en nn ern + 
“| ' Pointer to string | 

+ + Long 

| containing pathname 

hr ea nw en eee een ee + 

| SET-GET File Attributes | Word 

$e wn a n n rne nr en- + 
| Attributes to SET | Word re 
(ae Hanah ase saree Seat Soss-sSSe= + High memory 


Long contains the address of a null-terminated string containing 
the complete pathname of the specified file. 


Word contains a 0 to get the file’s attributes or a 1 to set the 
file’s attributes. 


Word indicates file attributes, depenaing on these values: 


01H File set to read-only 

02H File hidden from directory search 

04H File set to system, hidden from directory search 
O8H File contains volume label in first 11 bytes 

O1H File is a subdirectory . 

01H File has been written to and ciosed 


ST a ETT ee a 
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curn Parameters: 


gister DO.L : If it is a Get Attributes operation, the current 
attributes are returned in DO.L 
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8.42. 45: DUP 
LONG dup(stdhnd) 
WORD stdhna; 


{ 
} 


input is a standard handle. Output is a non-standard handle 
number that points to the same file or device as the standard 
handle did. 


RS IP ee, ee fern 


DUP 
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43. 46: FORCE 
VOID force(stdhnd, nsthnd) 


iy 


jt 


forces the standard handle to point to the same file or device as 
the non-standard handle. 


FORCE 
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8.44. 47: GETDIR 


LONG 
getdir(drvpath,drive) 

BYTE ‘*pdrvpath; 

WORD __ drive: 


bn eal ote} 


Parameter Block 


(users neoton on wae sete eoe tess 
| Function Code 47H. 

Ci weiGeucowercansehwetewceboeseos 
| Pointer to buffer 

* 

| . to receive pathname 

Sa ae eae aE P LES meee E SEH 
| Drive Code 

Pe a ee a ea ON A Se a oe ay I 


+ Low memory (Parameter 


+ 


+> 


+ 


Long 


Word 
High memory 


Long contains the address of a 64-byte buffer that receives the 


complete pathname of the current directory. 


Word specifies the drive: 0 = default drive. 1 = A, 2 
= B, etc. 


block addr) 


LIAL MP i “Teter ner ant tes e Og Gare: Prete ee INT Pk NNT O80 TEES UO eds lee 
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45. 48: MALLOC 


B LONG 
Bp :allac(nbytes) 
LONG nbytes; 


Parameter Block 


| tess sesame Sessseses secs er Tess + Low memory (Parameter 
| | Function Code 48H | block addr) 


He nn ne reer + High memory 


ng contains the number of bytes to allocate, or -1L 
*FFFFFFF), which returns maximum available memory. 


et irameters: 


€gister DO.L : if nbytes specifies the number of bytes to 
allocate, DO.L contains pointer to the starting 
address of the block of memory allocated. If 
allocation fails, 00.L contains 0. 


If nbytes equals FFFFFFFF, DO.L returns the 
number of available bytes. 
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8.46. 49: MFREE 


LONG 
mfree(maddr) 

LONG maddr; 
{ 
} 


Entry parameters: 


Register 


DO.W : 43H 
Parameter Block 
Function Code 49H 


em oe Oe wt oe ee me Oe oe me ee oe ee om me oe om om ow mm ot om ee ee om oe ow ee oe 


Long contains address of memory to free. 


Return Parameters: 


+ Low memory (Parameter 
| ' block addr) 


Register DO.L : Contains 0 if memory was freed, non-zero if an error occurred. 
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. 4A: SETBLOCK 


Parameter Block 


s dasieetenineniectteatestadnetatentenahet anata ieee + Low memory (Parameter 
| Function Code 4AH | block addr) 
$e on oo ee ee —+ 
Beginning address of | 
+ : memory space to + Long 
return to the OS | 
i ae ee eee + 
| Length of | 
+ + Long 
released memory | 
te a a ene + 


mrction: 
| the GEMDOS memory model, stack space grows downwards from high 
m™Ory and program and data space grows upwards from low memory. 
: @ SETBLOCK function cail polices memory space and reallocates 
mused memory for GEMDOS’s use. Long 1 contains the beginning 

ress of the memory to be returned to GEMDOS. Long 2 contains 

R les of the returned space. 


ern Parameters: 


motster DOL - Contains 0 if the block was adjusted successfully, 
non-zero if an error occurred. 


an] 
“ 
m 
oO 


Coe re re eee 


maen8 ad, semtere 
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8.48. 4B: EXEC 
LONG 
exec(load.pespec,pcmdin) 
WORD load; 
BYTE pespec; 
BYTE pedin; 
{ 
} 
Parameter Block 
teenar enn - anne se SaeSse=Sssesseo= + Low memory (Parameter 
| Function Code 4BH er block addr) 
peewee eee ee ee meen an ne ee + 
| Mode Word | Word 
© pee eee ee ee ee were we cesta teeetaalententestaaaatend + 
| Pointer to string | 
+ 
containing pathname. | 
pe a a a nr wn ow ww ew ewe + 
| 
+ Pointer to command tail + Long 
i | 
Hern ne rene omen ere ereceren= + High memory 


Word contains either a 0 or a 3, indicating these actions: 


0 = load and execute the program 
3 = load program but do not execute: used with overlays 


Long 1 is a pointer to a null-terminated string specifying the 
name of the file to load. 


Long 2 is a pointer to a command tail, which includes 


2 he ett ae 


ee eer ee teat ares Se Teeny 


: 
‘ 
i 


EXEC 
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mection details. 


mrn Parameters: 


mster OO.L : Contains base page address. 
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8.49. 4C: TERM 


VOID 
term() 
{ 
} 
Parameter Block 
perm Sass ee Ss ase s eS erste ses + Low memory (Parameter 
| Function Code 4CH | block addr) 
$e we we ww ew wo wn we ee ee ee ee eee + 
| Status Code ' | Word 
pose sees saa SSeee reer taaa San =2=s= + High memory 


Word contains a status code that can be interrogated by the 
parent process. 


Register DO.L : Contains 0 if the file was terminated successfully, 
non-zero if an error occurred. 


Function: 


This system cail terminates the current process and transfers 
control to the invoking process. 
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0. 40: Retrieve the Return Code of a Child 


Parameter Block 


porn an nn en nn mn nnn enna + Low memory (Parameter 
Function Code 4DH | block addr) 
poenwnee—--- Seer S SSS 5485 52s5>-5> + High memory 


cur meters: 


Hister DO.W : Contains the return code of the child process. 


GEMCOCS Spec Version & 77 SFIRST 


8.51. 4&: SFIRST 


LONG 
sfirst(pspec.attr) 
BYTE pspec: 
WORD attr: 
{ 
} : 
Parameter Block 
tem nr na ne enn n ene nn emer econ crocs + Low memory (Parameter 
| Function Code 4EH | block addr) 
pe ee en ew eo ee oe ee ee + 
| Pointer to string | 
+ + Long 
| “containing pathname | 
a ne nn we ee ee + 
| Search Attributes. | Word 
fees eSSSH SS lea SSeS esae Hele = + High memory 


Long is a pointer to the null-terminated string specifying the 
file to find. : 


Word contains a code specifying the search attributes, as shown 


below: 


00H 
01H 
02H 
04H 
08H 
10H 
20H 


File 
File 
File 
File 
File 
File 
File 


is normal file entry 

is read-only 

hidden from directory search 
is system file 

is a volume label 

is a subdirectory 

has been written to and ciosed 
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e search procedure take these codes into account in this way: 


- the attribute code is OOH find normal file entries only. No volume labels, 


ydirectories, hidden, or system files are accepted as matches. 


‘the attribute field is set for hidden or system files, they are included in the search set. 
look at all directory entries except the volume !abels, set the attribute bits for hidden, 


stem, and directory all on. 


‘the attribute field is set for the voiume label, the search only considers volume labels. 


furl imeters: 


gister D0.W : Contains 0 if no matching file was found: 
1 if matching file was found. 


action: 


arches for a match for the specified filename, according to the attribute bit settings 


Scribed above. If a match is found. a 44-byte OMA buffer is formatted as follows: 


Longs Contents 
Q Reserved for OS use 
2. File attributes 


22-23 File time stamp 
24-25 File date stamp 
> 26-27 Low word of file size 
* 28-29 High word of file size 
30-43 Name and extension of found file 
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8.52. 4F: SNEXT 


LONG 
snext() 
{ 
y 
Parameter Block 

tesessesss—Stesssee SeeSee SoSH R= + Low memory (Parameter 

| Function Code 4FH block addr) 

a a a a la ae a as + High memory 


Return Parameters: 


Register DO.W : Contains 0 if there are no more files to search: 
1 if there are further files available. 


Function: | 


This system cail uses the information specified in a previous Find Matching File system 
call to locate the next matching file.- The DMA butter bytes 0-20 must remain untouched 
from the previous SFIRST or SNEXT. If a file is found. the DMA buffer initialized in the 


Find Matching File system call is updated with the new filename. 


cE Y SSSR RE LP YE TE FS FER IEP or ™ 
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56: RENAME 


LONG 
pname(n.p 1,p2) 
WORD 7: 
BYTE ‘pl: . 
BYTE “p2; 


Parameter Block 


saa a ac + Low memory (Parameter 
I Function Code 56H | block addr) 


| Pathname of | -: 
: + Long 

| Existing File | 

Pathname of | 

. + Long 

Destination File | 

SETS Cesare ae SS ea + High memory 


"3 1 is a pointer to the pathname of the existing file 


9 2 is a pointer to the pathname of the destination file 


GEMOCS Spec Varsion 8 81 


8.54. 57: GSDTOF 


GSOTOF 


VOID 
gsctofi(h,buft.set) 
WORD h; : 
BYTE “buff; 
WORD set; 
{ 
} 

Parameter Block 
tonne eee en ee nen -------+ Low memory (Parameter 
| Function Code 57H | block addr) 
th a an we nr ee eee + 
| Pointer to buffer 
+ containing Time and _ + Long 
| Date information | 
ee ee ew ee we a we ee new ow ee eee + 
| File Handle | Word 
hae ee a en ww ee oe es + : 
| SET-GET Time and Date Info | Word 
a a aa a a + High memory 


Long is a pointer to a buffer that contains the data and time 
information. 


Word 1 is the specified file handle 


Word 2 is a flag specifying setting or return of data and time 
information. lf 0. set data and time: if 1. get data and time 
information. In either case, the buffer holds two words, with 
time first. The format of date and time is shown below: 


Bits 0 through 4 indicate the date in the range 7 - 31 
Bits 5 through 8 indicate the month in the range 1 - 12 
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9 through 15 indicate the year (since 1980) in the range 0-119 


0 through 4 indicate the binary number of two-second increments 
5 through 10 indicate the binary number of minutes 
11 through 15 indicate the binary number of hours 


RTS RN eS RT PE Bee A TY 


GSOTOF 
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9. BIOS Function Calls 


9.1. Parameter Format In Memory 

To preserve system security and integrity, the BIOS is callable only from supervisor 
mode. Applications that use the BIOS should follow these conventions, shown below in 
C: 


return_value = trap 13(function_number, parameter 1, parameter 2, ...); 


where ‘trap13’ is defined as: 


trap 13: 
move.| (Sp)+.retsave 
trap #13 
move.! retsave,-({sp) 
rts 


The parameters will then be on the stack in the form: 


parameter 2 
parameter_1 
WORD __ function_number 
LONG PC 
WORP status register 


oo 


0 tee 


vee 


vOIO get_mpb(p_mpb) 
MPB *p_mpb; 

{ 

} 


entry, p_mpb points to a ‘sizeot(MP8)’ byte block to be 
:. filled in with the system initial Memory Parameter Block. 
Upon return, the MP8 is filled in. 


Formats are as follows: 


MPB /* memory partition block */ 


{ 


MD *mp_mfl; 
MD *mp_mal; 
MD *mp_rover; 


e 
o 


* memory descriptor */ 
«“* Only 1 allowed in this first release */ 


MD *m_link; 

long M_ start; 

long m_length; 
, PD *m_own; 


e 
e 


Qo 
ss 


BIOS Calls 85 


8.3. 01 


LONG character_input_status(h) 
WORD h; 


{} 


fi is a character device handle that specifies one of the following 


devices: 

0 PRT: 
1 AUX: 
2 CON: 


Returns status in DO.L: 


1 device is ready 
0 device is not ready 


I RR EE a aa Si Ret ih hte Se 
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9.4. 02 
LONG character _input(h) 
wORD h; 


0 


h ‘is a character device handle described in Function 01. 


This function does not return until a character has been input. it returns the character 


vaiue in OO.L. with the high word set to zero. 


.~. ~JN:, it returns the IBM PC compatible scan code in the upper byte of the low word, 
and the ASCI! character in the lower byte, or zero in the lower byte if the character is 
non~ASCil. 


For AUX:, it returns the character in the low byte. - 


9.5. 03 
VOID character_output(h, char) 
WORD |, char; 


07 


h is a character device handle described in Function 01. 
char is a character in the low 8 bits of the word. 


This function does not return until the character has been output. 


©) 


G) 
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NG read _write_sectors(wrtfig, buffer, num, recn, drive) 
IRD wrtfig; 


iw *buftfer: 
‘RD num: 
RD recn; 
‘ROD 2: 


wrtfig is $0 for read, $1 for write 


buffer is a long pointer to a byte address for the disk transfer 
num is the number of sectors to transfer : oo 
recn is the beginning record number to transfer 

drive is 0 for drive A, 1 for drive 8, -. 


03 


ction returns a 2’s complement error number in DO.L. It is the responsibility of the 


er to check for media change before any write to FAT sectors. If media has changed. 


write shouid take place, just return with error code. 


BIOS Cails &9 


9.7. 0S 

LONG set_exception_vector(vecnum, vecadr) 
WORD vecnum; 
LONG vecadr; 


{} 
vecnum is the number of the exception vector to get or set 
vecadr is the long address to set into the exception 


vector table. NO set is done if vecadr is -1. . 


Function returns a long address that was the previous entry. 


eee EP 


ee 
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9.8. 06 ss 


LONG get_timer_ticks() 
0 


Returns the nearest number of milliseconds per tick in D0.L 


Why not make this microseconds per tick, and eliminate parameter 
on tick trap? 


SS a ae a iv ge — -- ara Fis Sea G a aban Mo. Siete ot Sa ie etek Se Me 


ieee 
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9.9. 07 


BPB “get_bpb(d) 
WORD da: 
{} 


d is 0 for drive A, 1 for drive B, ... 


Returns a pointer to the BIOS Parameter Block for the specified 
drive in DO.L. If necessary, it should read boot header 
information from the media in the drive to determine BPB values. 


06 
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08 


character _output_status(h) 
a nh; 


! character device handle described in Function 01. 


ms status in OO.L: 


J device is ready 
J device is not ready 


nm a I ha aa i a 
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9.11. Extended Functions 
Function 7? 


Exchange mouse vector 


Function 7? 


Exchange VBLANK vector 


$3 


ce 
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Timer Ticks ; 
| BIOS must trap into the BDOS on every timer tick The BIOS 
-e@s in 1 parameter - the number of milliseconds since the last 


Which trap? 
~ In register or on stack? 
‘See issue above on function 06. 
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lopment Environment 


3. Object File Format 
3.1. Advantages of the GEMDOS Object File Format 
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3.3. 
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Changes to the File Header 
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Notes For Writing Loaders 


4. CCP Commands 
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6. Base 


Page Format 


7. System Status Codes 


7.0.1. Error Codes 


8. System Function Calls 


8.1. 
8.2. 
8.3. 
8.4. 
8.5. 
8.6. 
8.7. 
8.8. 
8.9. 


GEMDOS Parameter Passing Conventions 
Returned Data - 

00: TERM 

01: CONIN 

02: CONOUT 

03: Auxiliary input 

04: Auxiliary Output 

05: Printer Output 

06: RAWCONIO 


8.10. 07: Direct Con In Without Echo 
8.11. 08: Con In Weisout Echo 
8.12. 09: PRT_LINE 


8.13. 
8.14. 
8.15. 
8.16. 
8.17. 
8.18. 
8.19. 
8.20. 
8.21. 


OA: READLINE 

08: CONSTAT 

XX: AUXIN_STAT 

XX AUXOUT_STAT 
xX: CONOUT_STAT - 
XX: PRTOUT_STAT 
OD: Reset Disk 

OE: SETDRV 

19: Current Disk 


8.22. 1A: Set Disk Transfer Address 


8.23. 
8.24. 
8.25. 
8.26. 
8.27. 
8.28. 
8.29. 


2A: Get Date 

2B: Set Date 

2C: Get Time 

2D: Set Time 

2F: GETDTA 

30: Get Version Number 

31: Keep Process (Terminate and Stay Resident) 
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8.30. 
8.31. 
3.32. 
8.33. 
8.34. 
8.35. 
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8.37. 
8.38. 
8.39. 
8.40. 
8.41. 
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36: 
39: 
3A: 
3B: 
3c: 
30: 
3E: 
3F: 
40: 
41: 
42: 
43: 
45: 
46: 
47: 
48: 


Get Disk Free Space 
MKDIR 
RMDIR 
CHDIR 
CREATE 
OPEN 
CLOSE 
READ 
WRITE 
UNLINK 
LSEEK 
CHMOD 
DUP 
FORCE 
GETDIR 
MALLOC 


: MFREE 


4c: 
40: 
4é: 


56: 
57: 


: SETBLOCK 
8.48. 48: 
8.49, 
8.50. 
8.51. 
8.52. 4F: 
8.53. 
8.54. 


EXEC 

TERM 
Retrieve the Return Code of a Child 
SFIRST 

SNEXT 

RENAME 

GSDTOF 


8IOS Function Calls 

9.1. Parameter Format In Memory 
9.2 90 
9.3. 01 
3.4. 02 
9.5. 03 


9. 
9. 


9.6. 04 


9.9. 07 


3.10. 
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9.11. Extended Functions 
212. Timer Ticks , 
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MMultitasking 


: fwo multitasking schemes are proposed. Both maintain complete process models in 


ory. Both types can exist concurrently within the system. 


| The first type of multitasking is a background activity (such aS communications or 
inter spooling) that is interrupt driven and requires only a small percentage of the total 
mcessing time. Such tasks can run concurrently with a foreground process. Only one 


ackaround process can run at any given time. 


: The second type of multitasking allows two or more processes in the foreground at 
: ace. with all processes suspended but the one in the active window. The active window 
1 defined by the cursor position ~ moving the cursor from one window to another 
tezes the process the cursor leaves and activates the one it enters. When activated, a 
vecess retrieves an intertask communication from a designated ¢.0e or queue. The 


amber of applications running in this mode are limited only by availé<ie memory. 
B Real Time Response 


The design goal for handling real-time interrupts and excepticn requests is 100 
ticroseconds or less. This response speed supports foregrou:d communications 


9p! IS running at XXX 


